
/*
 * Copyright 2002-2022 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
/*
 *版权所有2002-2022原作者。
 *
 *根据Apache许可证2.0版（“许可证”）许可；
 *除非符合许可证的规定，否则您不得使用此文件。
 *您可以在以下网址获取许可证副本
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 *除非适用法律要求或书面同意，否则软件
 *根据许可证分发是在“按原样”的基础上分发的，
 *无任何明示或暗示的保证或条件。
 *有关管理权限的特定语言，请参阅许可证
 *许可证下的限制。
 */

package org.springframework.context.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import org.springframework.aot.hint.RuntimeHintsRegistrar;

/**
 * Indicates that one or more {@link RuntimeHintsRegistrar} implementations
 * should be processed.
 *
 * <p>Unlike declaring {@link RuntimeHintsRegistrar} using
 * {@code META-INF/spring/aot.factories}, this annotation allows for more flexible
 * registration where it is only processed if the annotated component or bean
 * method is actually registered in the bean factory. To illustrate this
 * behavior, consider the following example:
 *
 * <pre class="code">
 * &#064;Configuration
 * public class MyConfiguration {
 *
 *     &#064;Bean
 *     &#064;ImportRuntimeHints(MyHints.class)
 *     &#064;Conditional(MyCondition.class)
 *     public MyService myService() {
 *         return new MyService();
 *     }
 *
 * }</pre>
 *
 * <p>If the configuration class above is processed, {@code MyHints} will be
 * contributed only if {@code MyCondition} matches. If the condition does not
 * match, {@code MyService} will not be defined as a bean and the hints will
 * not be processed either.
 *
 * <p>{@code @ImportRuntimeHints} can also be applied to any test class that uses
 * the <em>Spring TestContext Framework</em> to load an {@code ApplicationContext}.
 *
 * <p>If several components or test classes refer to the same {@link RuntimeHintsRegistrar}
 * implementation, the registrar will only be invoked once for the given bean factory
 * processing or test suite.
 *
 * @author Brian Clozel
 * @author Stephane Nicoll
 * @since 6.0
 * @see org.springframework.aot.hint.RuntimeHints
 * @see org.springframework.aot.hint.annotation.Reflective
 * @see org.springframework.aot.hint.annotation.RegisterReflectionForBinding
 */
/**
 *指示一个或多个｛@link RuntimeHintsRegistrar｝实现
 *应进行处理。
 *
 *<p>与使用声明｛@link RuntimeHintsRegistrar｝不同
 *｛@code META-INF/spring/aot.factors｝，此注释允许更灵活
 *注册，其中只有在带注释的组件或bean
 *方法实际上是在bean工厂中注册的。为了说明这一点
 *行为，请考虑以下示例：
 *
 *<pre-class=“code”>
 * &#064;配置
 *公共类MyConfiguration{
 *
 *     &#064;豆
 *     &#064;导入运行时间提示（MyHints.class）
 *     &#064;条件性（MyCondition.class）
 *公共MyService MyService（）{
 *返回new MyService（）；
 *     }
 *
 *}</pre>
 *
 *＜p＞如果处理了上面的配置类，｛@code MyHints｝将
 *仅当｛@code MyCondition｝匹配时才贡献。如果条件不是
 *匹配，｛@code MyService｝将不会被定义为bean，提示将
 *也不进行处理。
 *
 *＜p＞｛@code@ImportRuntimeHints｝也可以应用于任何使用
 *＜em＞Spring TestContext Framework＜/em＞来加载｛@code ApplicationContext｝。
 *
 *<p>如果多个组件或测试类引用同一个｛@link RuntimeHintsRegistrar｝
 *实现时，对于给定的bean工厂，注册器将只被调用一次
 *处理或测试套件。
 *
 *@作者Brian Clozel
 *@作者Stephane Nicoll
 *@自6.0起
 *@参见org.springframework.aot.hint.Runtime提示
 *@参见org.springframework.aot.hint.annotation.Reflective
 *@参见org.springframework.aot.hint.annotation.RegisterReflectionForBinding
 */
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ImportRuntimeHints {

	/**
	 * {@link RuntimeHintsRegistrar} implementations to process.
	 */
	/**
	 *｛@link RuntimeHintsRegistrar｝要处理的实现。
	 */
	Class<? extends RuntimeHintsRegistrar>[] value();

}
